首页 » 知识库 » Obsidian Claude Sidebar —— 把 Claude Code 钉在侧边栏，笔记和 AI 同屏协作

Obsidian Claude Sidebar —— 把 Claude Code 钉在侧边栏，笔记和 AI 同屏协作

554 字

wuxl obsidian学习教程 2026年6月22日 16:59

图片

Obsidian Claude Sidebar —— 把 Claude Code 钉在侧边栏，笔记和 AI 同屏协作

插件地址：https://github.com/derek-larson14/obsidian-claude-sidebar

作者：Derek Larson

许可证：MIT

Obsidian 里用 AI，最常见的姿势是切到终端、敲几行命令、再切回来——反复横跳，体验稀碎。Claude Sidebar 的思路简单粗暴： 在 Obsidian 侧边栏里跑一个完整的终端，Claude Code 就住在里面 。你再也不用离开 Obsidian，AI 就在你笔记旁边随时待命。

基础介绍

是什么

Claude Sidebar 是一个社区插件，它在 Obsidian 侧边栏嵌入了一个终端模拟器（基于 xterm.js），自动启动 Claude Code（或其他 AI CLI 工具），让你在写笔记的同时直接跟 AI 对话。

底层原理也不复杂：macOS/Linux 上用的是 Python 的 pty 模块开一个伪终端，Windows 上用 pywinpty。终端跑的就是你本地装的那个 Claude Code——不是什么远程 API 调用，所有对话和数据全在你机器上。

核心能力

  • 侧边栏里跑 Claude Code ——打开插件，Claude 自动启动，零额外操作
  • 多 Tab ——可以同时开好几个 Claude 实例，互不干扰
  • 多后端支持 ——不只能跑 Claude Code，还支持 Codex、Gemini CLI、OpenCode、Kimi Code、GitHub Copilot、Cursor Agent、Pi 等，一键切换
  • 右键菜单集成 ——右键文件夹可以在那个目录启动 Claude，右键文件可以直接把文件路径喂给 Claude
  • YOLO 模式 ——跳过权限确认，适合你确信安全的操作
  • 命令面板全覆盖 ——打开、新建 Tab、关闭 Tab、切换焦点、发送文件路径、发送选中文本……全有命令

使用场景

场景一：边写笔记边问 AI

写一篇技术笔记，碰到不确定的概念，不用切窗口。侧边栏喊一声 Claude，问完继续写。整个过程你的视线都不用离开 Obsidian。

场景二：用 AI 分析某个文件夹里的笔记

右键某个文件夹 →「Open Claude here」→ Claude 的当前工作目录就切到了那个文件夹。你可以让他"总结这个文件夹里所有笔记的核心观点"或者"帮我找出逻辑矛盾"。

场景三：多任务并行

左边 Tab 跑一个 Claude Code 在改某个项目的代码，右边 Tab 在帮另一篇笔记做内容审校。多 Tab 的设计在这种场景下简直救命。

场景四：快速审校 & 翻译

选中一段文字 → Ctrl/Cmd + P →「Send Selection to Claude」→ Claude 直接拿到你选中的内容，接着让它润色、翻译、改错别字都行。

场景五：多 AI 对比

Team Gemini 和 Team Claude 吵了这么多年，你可以同时开两个 Tab，一个跑 Gemini，一个跑 Claude，同一个问题丢两边，看看谁的答案更靠谱。从设置里切一下后端就行，几秒钟的事。

基本使用

安装

macOS / Linux

社区插件市场直接搜 Claude Sidebar → 安装 → 启用。前提是你本地已经装了 Claude Code 或其他支持的 CLI。

Windows 用户需要额外三步（敲黑板，这里是踩坑高发区）：

  1. 从 python.org 安装 Python 3
  2. 装 pywinpty， 注意一定要用以下方式 ：

py -m pip install pywinpty

千万别直接敲 pip install pywinpty ，那可能装到另一个 Python 解释器里去，插件会找不到包。如果装完插件还报 "pywinpty not installed"，看错误信息里打印的 Python 解释器路径，对着那个解释器再装一次。

  1. 在插件设置里选 Shell 类型：
  2. cmd.exe （默认）——直接用 Windows 命令提示符，不做路径转换
    • wsl.exe （WSL）——如果你的 Claude Code、Node、Git 工具链都在 WSL 里，选这个。插件会自动把 Windows 路径转成 WSL 里的 Linux 路径

WSL 用户如果 vault 路径解析不对，检查 /etc/wsl.conf 里的 [automount] 配置，确保挂载路径对得上。

打开 Claude

点击左侧功能区的机器人图标，侧边栏弹出，Claude Code 自动启动。什么都没按，AI 就位了。

核心操作

右键机器人图标 可以选：

  • 正常启动
  • YOLO 模式启动（跳过权限确认）
  • 指定文件夹启动
  • 恢复上次对话（ --continue ）

右键文件夹 ：

  • 「Open Claude here」——在该目录启动 Claude
  • 「Open Claude here (YOLO)」——跳过权限确认版

右键文件 ：

  • 直接把文件路径发给 Claude

命令面板（ Ctrl/Cmd + P ）搜这些命令：

命令 作用
Open Claude Code 打开 Claude
New Claude Tab 新建一个 Tab
Close Claude Tab 关闭当前 Tab
Toggle Focus: Editor ↔ Claude 编辑器跟侧边栏切焦点
Run Claude from this folder 在当前笔记所在目录启动 Claude
Resume last conversation 恢复上次对话
Send File Path to Claude 把当前文件路径发给 Claude
Send Selection to Claude 把选中的文本发给 Claude

多行输入

按 Shift + Enter 换行，这个跟终端里的习惯一样。

自定义快捷键

去设置 → 快捷键 → 搜 Claude Sidebar ，把常用的命令绑上顺手组合键。建议至少绑定「Toggle Focus」和「Send Selection to Claude」，使用频率最高。

进阶使用

多后端切换

这个插件的隐藏大招是它不只认 Claude Code。支持的后端列表：

  • Claude Code（默认）
  • Codex
  • OpenCode
  • Gemini CLI
  • Kimi Code
  • GitHub Copilot
  • Cursor Agent
  • Pi

切换方式：设置 → Claude Sidebar → 选 CLI Provider，或者命令面板搜「Switch CLI provider…」。切换即时生效，不需要重启 Obsidian。

这意味着你可以：

  • 写代码时用 Claude Code
  • 翻译中文内容时切到 Kimi Code（中文是母语级）
  • 审查代码时换 Gemini
  • 各取所长，不用绑死在一个工具上

YOLO 模式正确使用姿势

YOLO 模式等价于命令行加 --dangerously-skip-permissions 。适合的场景：

  • 你很清楚 Claude 要做什么，而且信任它的操作
  • 批处理任务，不想被权限确认打断十几次

不适合的场景：

  • 涉及删除文件、修改系统配置的操作
  • 你不确定 AI 产出的代码质量，需要每一步看一眼

一句话：信得过的时候才开 YOLO，不确定的时候宁可慢慢确认。

路径上下文自动化

这个插件在设计上很懂 Obsidian 用户的痛点——路径的传递：

  • 右键文件 →「Send File Path to Claude」，Claude 拿到路径后可以直接读文件
  • 选中文本 →「Send Selection to Claude」，Claude 拿到你选的内容当上下文
  • 拖拽文件到侧边栏也行

实际工作流是：你在笔记里写需求 → 选中发给 Claude → Claude 给你方案 → 你直接在编辑区实现。整个过程手不离开键盘。

恢复上次对话

有时候聊到一半关掉了（比如不小心点了关闭 Tab），别慌。命令面板 →「Resume last conversation」，Claude 用 --continue 参数重新启动，接着上次的话题继续。上下文不丢。

Windows WSL 环境调优

如果你在 WSL 里跑 Claude Code，建议：

  • 插件设置选 wsl.exe 模式
  • 确认 vault 存放在 WSL 能访问到的路径（比如 /home/user/vault 而不是 Windows 的 C:\Users\...）
  • 如果 vault 必须在 Windows 侧，检查 /etc/wsl.conf 里 automount 的 root 设置

# /etc/wsl.conf 示例 [automount] root = /

这样 C:\ 就会挂载到 /c/ ，插件自动把路径翻译成 /c/Users/...，Claude 在 WSL 里就能读到文件。

小结

Claude Sidebar 属于那种" 装上之后大脑会发出舒适信号 "的插件。它的价值不在技术有多复杂——本质上就是一个嵌入的终端——而在于 消灭了 Obsidian ↔ AI 之间的上下文切换成本 。

三个核心优势：

  1. 零摩擦启动 ——点一下图标，AI 已在侧边栏就位，不需要切窗口、不需要复制粘贴
  2. 多后端自由切换 ——Claude Code 不是唯一选择，Codex、Gemini、Kimi 随你挑，各取所长
  3. 跟 vault 深度绑定 ——右键就能在某个文件夹启动 AI，选中文本就能发给 AI，路径上下文自动传递

唯一需要注意的是 Windows 下的 pywinpty 安装坑——记住 py -m pip ，别用裸 pip ，能省一小时的排查时间。

如果你日常在 Obsidian 里写东西且经常求助 AI，这插件基本是必装。毕竟，能少切一次窗口就少切一次——那句话怎么说来着，"程序员的时间最大敌人不是 Bug，是上下文切换"。

obsidian-plugin-教程 · 目录

💬 讨论 (0) 发起新帖 ← 返回知识库